home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / xlock.1 < prev    next >
Encoding:
Text File  |  1995-07-26  |  18.1 KB  |  331 lines
  1.  
  2.  
  3.  
  4.      XXXXLLLLOOOOCCCCKKKK((((1111))))           XXXX11111111RRRR5555 CCCCoooonnnnttttrrrriiiibbbb ((((22227777 SSSSeeeepppp 1111999999991111))))           XXXXLLLLOOOOCCCCKKKK((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xlock - Locks the local X display until a password is
  10.           entered.
  11.  
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           xxxxlllloooocccckkkk [ ----ddddiiiissssppppllllaaaayyyy _d_s_p ] [ ----hhhheeeellllpppp ] [ ----nnnnaaaammmmeeee_r_e_s_o_u_r_c_e-_n_a_m_e ] [
  15.           ----rrrreeeessssoooouuuurrrrcccceeeessss ] [ ----////++++rrrreeeemmmmooootttteeee ] [ ----////++++mmmmoooonnnnoooo ] [ ----////++++nnnnoooolllloooocccckkkk ] [ ----
  16.           ////++++aaaalllllllloooowwwwrrrrooooooootttt ] [ ----////++++eeeennnnaaaabbbblllleeeessssaaaavvvveeeerrrr ] [ ----////++++aaaalllllllloooowwwwaaaacccccccceeeessssssss ] [ ----
  17.           ////++++eeeecccchhhhooookkkkeeeeyyyyssss ] [ ----////++++uuuusssseeeeffffiiiirrrrsssstttt ] [ ----////++++vvvv ] [ ----ddddeeeellllaaaayyyy _u_s_e_c_s ] [
  18.           ----bbbbaaaattttcccchhhhccccoooouuuunnnntttt _n_u_m ] [ ----ppppooooiiiinnnnttttssss _n_u_m ] [ ----nnnniiiicccceeee _l_e_v_e_l ] [ ----ttttiiiimmmmeeeeoooouuuutttt
  19.           _s_e_c_o_n_d_s ] [ ----ssssaaaattttuuuurrrraaaattttiiiioooonnnn _v_a_l_u_e ] [ ----ffffoooonnnntttt _f_o_n_t_n_a_m_e ] [ ----bbbbgggg
  20.           _c_o_l_o_r ] [ ----ffffgggg _c_o_l_o_r ] [ ----mmmmooooddddeeee _m_o_d_e ] [ ----uuuusssseeeerrrrnnnnaaaammmmeeee _t_e_x_t_s_t_r_i_n_g
  21.           ] [ ----ppppaaaasssssssswwwwoooorrrrdddd _t_e_x_t_s_t_r_i_n_g ] [ ----iiiinnnnffffoooo _t_e_x_t_s_t_r_i_n_g ] [ ----vvvvaaaalllliiiiddddaaaatttteeee
  22.           _t_e_x_t_s_t_r_i_n_g ] [ ----iiiinnnnvvvvaaaalllliiiidddd _t_e_x_t_s_t_r_i_n_g ]
  23.  
  24.  
  25.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.           xxxxlllloooocccckkkk locks the X server till the user enters their password
  27.           at the keyboard.  While xxxxlllloooocccckkkk is running, all new server
  28.           connections are refused.  The screen saver is disabled.  The
  29.           mouse cursor is turned off.  The screen is blanked and a
  30.           changing pattern is put on the screen.  If a key or a mouse
  31.           button is pressed then the user is prompted for the password
  32.           of the user who started xxxxlllloooocccckkkk....
  33.  
  34.           If the correct password is typed, then the screen is
  35.           unlocked and the X server is restored.  When typing the
  36.           password Control-U and Control-H are active as kill and
  37.           erase respectively.  To return to the locked screen, click
  38.           in the small icon version of the changing pattern.
  39.  
  40.  
  41.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  42.           ----ddddiiiissssppppllllaaaayyyy  ddddsssspppp
  43.                The _d_i_s_p_l_a_y option sets the X11 display to lock.  xxxxlllloooocccckkkk
  44.                locks all available screens on a given server, and
  45.                restricts you to locking only a local server such as
  46.                uuuunnnniiiixxxx::::0000,,,, llllooooccccaaaallllhhhhoooosssstttt::::0000,,,, or ::::0000 unless you set the ----rrrreeeemmmmooootttteeee
  47.                option.
  48.  
  49.           ----nnnnaaaammmmeeee  rrrreeeessssoooouuuurrrrcccceeee----nnnnaaaammmmeeee
  50.                _r_e_s_o_u_r_c_e-_n_a_m_e is used instead of XXXXLLLLoooocccckkkk when looking for
  51.                resources to configure xlock.
  52.  
  53.           ----mmmmooooddddeeee  mmmmooooddddeeeennnnaaaammmmeeee
  54.                As of this writing there are eight display modes
  55.                supported (plus one more for random selection of one of
  56.                the eight).
  57.  
  58.           hhhhoooopppp     Hop mode shows the "real plane fractals" from the
  59.                   September 1986 issue of Scientific American.
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/9/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXLLLLOOOOCCCCKKKK((((1111))))           XXXX11111111RRRR5555 CCCCoooonnnnttttrrrriiiibbbb ((((22227777 SSSSeeeepppp 1111999999991111))))           XXXXLLLLOOOOCCCCKKKK((((1111))))
  71.  
  72.  
  73.  
  74.           lllliiiiffffeeee    Life mode shows Conway's game of life.
  75.  
  76.           qqqqiiiixxxx     Qix mode shows the spinning lines similar to the old
  77.                   video game by the same name.
  78.  
  79.           iiiimmmmaaaaggggeeee   Image mode shows several sun logos randomly
  80.                   appearing on the screen.
  81.  
  82.           sssswwwwaaaarrrrmmmm   Swarm mode shows a swarm of bees following a wasp.
  83.  
  84.           rrrroooottttoooorrrr   Rotor mode shows a swirling rotorlike thing.
  85.  
  86.           ppppyyyyrrrroooo    Pyro mode shows fireworks.
  87.  
  88.           ffffllllaaaammmmeeee   Flame mode shows wierd but cool cosmic flame
  89.                   fractals.
  90.  
  91.           wwwwoooorrrrmmmm    Worm mode shows wiggly worms...
  92.  
  93.           sssspppplllliiiinnnneeee  Spline mode shows pretty bouncing splines.
  94.  
  95.           bbbbllllaaaannnnkkkk   Blank mode shows nothing but a black screen.
  96.  
  97.           rrrraaaannnnddddoooommmm  Random mode picks a random mode from all of the
  98.                   above except blank mode.
  99.  
  100.  
  101.           ----ddddeeeellllaaaayyyy  uuuusssseeeeccccssss
  102.                The _d_e_l_a_y option sets the speed at which a mode will
  103.                operate.  It simply sets the number of microseconds to
  104.                delay between batches of "hopalong pixels", "qix
  105.                lines", "life generations", "image blits", and "swarm
  106.                motions".  In blank mode, it is important to set this
  107.                to some small number of seconds, because the keyboard
  108.                and mouse are only checked after each delay, so you
  109.                cannot set the delay too high, but a delay of zero
  110.                would needlessly consume cpu checking for mouse and
  111.                keyboard input in a tight loop, since blank mode has no
  112.                work to do.
  113.  
  114.           ----bbbbaaaattttcccchhhhccccoooouuuunnnntttt  nnnnuuuummmm
  115.                The _b_a_t_c_h_c_o_u_n_t option sets number of _t_h_i_n_g_s to do per
  116.                batch to _n_u_m . In hop mode this refers to the number of
  117.                pixels rendered in the same color.  In life mode it is
  118.                the number of generations to let each species live.  In
  119.                qix mode it is the number of lines rendered in the same
  120.                color.  In image mode it is the number of sunlogos on
  121.                screen at once.  In swarm mode it is the number of
  122.                bees.  In rotor mode it is the number of rotor thingys
  123.                which whirr...  In pyro mode it is the maximum number
  124.                flying rockets at one time.  In flame mode it is the
  125.                number of levels to recurse (larger = more complex).
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/9/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXLLLLOOOOCCCCKKKK((((1111))))           XXXX11111111RRRR5555 CCCCoooonnnnttttrrrriiiibbbb ((((22227777 SSSSeeeepppp 1111999999991111))))           XXXXLLLLOOOOCCCCKKKK((((1111))))
  137.  
  138.  
  139.  
  140.                In worm mode it is the number of worms.  In spline mode
  141.                it is the number of splines.  In blank mode it means
  142.                nothing.
  143.  
  144.           ----ppppooooiiiinnnnttttssss  nnnnuuuummmm
  145.                The _p_o_i_n_t_s option sets the number of points used for
  146.                the spline outline.
  147.  
  148.           ----nnnniiiicccceeee  nnnniiiicccceeeelllleeeevvvveeeellll
  149.                The _n_i_c_e option sets system nicelevel of the xlock
  150.                process to _n_i_c_e_l_e_v_e_l .
  151.  
  152.           ----ttttiiiimmmmeeeeoooouuuutttt  sssseeeeccccoooonnnnddddssss
  153.                The _t_i_m_e_o_u_t option sets the number of _s_e_c_o_n_d_s before
  154.                the password screen will time out.
  155.  
  156.           ----ssssaaaattttuuuurrrraaaattttiiiioooonnnn  vvvvaaaalllluuuueeee
  157.                The _s_a_t_u_r_a_t_i_o_n option sets saturation of the color ramp
  158.                used to _v_a_l_u_e . 0 is grayscale and 1 is very rich
  159.                color.  0.4 is a nice pastel.
  160.  
  161.           ----ffffoooonnnntttt  ffffoooonnnnttttnnnnaaaammmmeeee
  162.                The _f_o_n_t option sets the font to be used on the prompt
  163.                screen.
  164.  
  165.           ----ffffgggg  ccccoooolllloooorrrr
  166.                The _f_g option sets the color of the text on the
  167.                password screen to _c_o_l_o_r .
  168.  
  169.           ----bbbbgggg  ccccoooolllloooorrrr
  170.                The _b_g option sets the color of the background on the
  171.                password screen to _c_o_l_o_r .
  172.  
  173.           ----uuuusssseeeerrrrnnnnaaaammmmeeee  tttteeeexxxxttttssssttttrrrriiiinnnngggg
  174.                _t_e_x_t_s_t_r_i_n_g is shown in front of user name, defaults to
  175.                "Name: ".
  176.  
  177.           ----ppppaaaasssssssswwwwoooorrrrdddd  tttteeeexxxxttttssssttttrrrriiiinnnngggg
  178.                _t_e_x_t_s_t_r_i_n_g is the password prompt string, defaults to
  179.                "Password: ".
  180.  
  181.           ----iiiinnnnffffoooo  tttteeeexxxxttttssssttttrrrriiiinnnngggg
  182.                _t_e_x_t_s_t_r_i_n_g is an informational message to tell the user
  183.                what to do, defaults to "Enter password to unlock;
  184.                select icon to lock.".
  185.  
  186.           ----vvvvaaaalllliiiiddddaaaatttteeee _t_e_x_t_s_t_r_i_n_g
  187.                _t_e_x_t_s_t_r_i_n_g ----vvvvaaaalllliiiiddddaaaatttteeee _m_e_s_s_a_g_e _s_h_o_w_n _w_h_i_l_e _v_a_l_i_d_a_t_i_n_g _t_h_e
  188.                _p_a_s_s_w_o_r_d, _d_e_f_a_u_l_t_s _t_o "Validating login..."
  189.  
  190.           ----iiiinnnnvvvvaaaalllliiiidddd _t_e_x_t_s_t_r_i_n_g
  191.                _t_e_x_t_s_t_r_i_n_g ----iiiinnnnvvvvaaaalllliiiidddd _m_e_s_s_a_g_e _s_h_o_w_n _w_h_e_n _p_a_s_s_w_o_r_d _i_s
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/9/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXLLLLOOOOCCCCKKKK((((1111))))           XXXX11111111RRRR5555 CCCCoooonnnnttttrrrriiiibbbb ((((22227777 SSSSeeeepppp 1111999999991111))))           XXXXLLLLOOOOCCCCKKKK((((1111))))
  203.  
  204.  
  205.  
  206.                _i_n_v_a_l_i_d, _d_e_f_a_u_l_t_s _t_o "Invalid login."
  207.  
  208.  
  209.           ----rrrreeeessssoooouuuurrrrcccceeeessss
  210.                The _r_e_s_o_u_r_c_e_s option prints the default resource file
  211.                for xlock to standard output.
  212.  
  213.           ----////++++rrrreeeemmmmooootttteeee
  214.                The _r_e_m_o_t_e option tells xlock to not stop you from
  215.                locking remote X11 servers.  This option should be used
  216.                with care and is intended mainly to lock X11 terminals
  217.                which cannot run _x_l_o_c_k locally.  If you lock someone
  218.                else's workstation, they will have to know yyyyoooouuuurrrr
  219.                password to unlock it.
  220.  
  221.           ----////++++mmmmoooonnnnoooo
  222.                The _m_o_n_o option causes xlock to display monochrome,
  223.                (black and white) pixels rather than the default
  224.                colored ones on color displays
  225.  
  226.           ++++////----nnnnoooolllloooocccckkkk
  227.                The _n_o_l_o_c_k option causes xlock to only draw the
  228.                patterns and not lock the display.  A keypress or a
  229.                mouse click will terminate the screen saver.
  230.  
  231.           ----////++++aaaalllllllloooowwwwrrrrooooooootttt
  232.                The _a_l_l_o_w_r_o_o_t option allows the root password to unlock
  233.                the server as well as the user who started xlock.
  234.  
  235.           ----////++++eeeennnnaaaabbbblllleeeessssaaaavvvveeeerrrr
  236.                By default xlock will disable the normal X server's
  237.                screen saver since it is in effect a replacement for
  238.                it.  Since it is possible to set delay parameters long
  239.                enough to cause phosphor burn on some displays, this
  240.                option will turn back on the default screensaver which
  241.                is very careful to keep most of the screen black.
  242.  
  243.           ----////++++aaaalllllllloooowwwwaaaacccccccceeeessssssss
  244.                This option is required for servers which do not allow
  245.                clients to modify the host access control list.  It is
  246.                also useful if you need to run x clients on a server
  247.                which is locked for some reason...  When allowaccess is
  248.                true, the X11 server is left open for clients to attach
  249.                and thus lowers the inherent security of this
  250.                lockscreen.  A side effect of using this option is that
  251.                if xlock is killed -KILL, the access control list is
  252.                not lost.
  253.  
  254.           ----////++++eeeecccchhhhooookkkkeeeeyyyyssss
  255.                The _e_c_h_o_k_e_y_s option causes xlock to echo '?' characters
  256.                for each key typed into the password prompt.  Some
  257.                consider this a security risk, so the default is to not
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 3/9/94)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXLLLLOOOOCCCCKKKK((((1111))))           XXXX11111111RRRR5555 CCCCoooonnnnttttrrrriiiibbbb ((((22227777 SSSSeeeepppp 1111999999991111))))           XXXXLLLLOOOOCCCCKKKK((((1111))))
  269.  
  270.  
  271.  
  272.                echo anything.
  273.  
  274.           ----////++++uuuusssseeeeffffiiiirrrrsssstttt
  275.                The _u_s_e_f_i_r_s_t option causes xlock to use the keystroke
  276.                which got you to the password screen as the first
  277.                character in the password.  The default is to ignore
  278.                the first key pressed.
  279.  
  280.           ----vvvv   Verbose mode, tells what options it is going to use.
  281.  
  282.  
  283.      BBBBUUUUGGGGSSSS
  284.           "kill -KILL xxxxlllloooocccckkkk " causes the server that was locked to be
  285.           unusable, since all hosts (including localhost) were removed
  286.           from the access control list to lock out new X clients, and
  287.           since xlock couldn't catch SIGKILL, it terminated before
  288.           restoring the access control list.  This will leave the X
  289.           server in a state where "_y_o_u _c_a_n _n_o _l_o_n_g_e_r _c_o_n_n_e_c_t _t_o _t_h_a_t
  290.           _s_e_r_v_e_r, _a_n_d _t_h_i_s _o_p_e_r_a_t_i_o_n _c_a_n_n_o_t _b_e _r_e_v_e_r_s_e_d _u_n_l_e_s_s _y_o_u
  291.           _r_e_s_e_t _t_h_e _s_e_r_v_e_r."           -From the X11R4 Xlib
  292.           Documentation, Chapter 7.
  293.  
  294.           NCD terminals do not allow xlock to remove all the hosts
  295.           from the access control list.  Therefore you will need to
  296.           use the "-remote" and "-noaccess" switches.  If you happen
  297.           to run without "-noaccess" on an NCD terminal, xxxxlllloooocccckkkk won't
  298.           work and you will need to reboot the terminal, or simply go
  299.           into the SETUP menus, under 'Network Parameters', and turn
  300.           off TCP/IP access control.
  301.  
  302.  
  303.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  304.           X(1), Xlib Documentation.
  305.  
  306.      AAAAUUUUTTTTHHHHOOOORRRR
  307.            Patrick J. Naughton      (naughton@eng.sun.com)
  308.            Mailstop 21-14
  309.            Sun Microsystems Laboratories, Inc.
  310.            Mountain View, CA  94043
  311.            415/336-1080
  312.  
  313.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  314.           Copyright (c) 1988-91 by Patrick J. Naughton
  315.  
  316.           Permission to use, copy, modify, and distribute this
  317.           software and its documentation for any purpose and without
  318.           fee is hereby granted, provided that the above copyright
  319.           notice appear in all copies and that both that copyright
  320.           notice and this permission notice appear in supporting
  321.           documentation.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                           (printed 3/9/94)
  328.  
  329.  
  330.  
  331.